home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / maestro / docmnttn / errorrpr.txt next >
Encoding:
Text File  |  1993-06-15  |  3.3 KB  |  85 lines
  1. Error Reporting Form for the MAEstro Multimedia Authoring Environment
  2.  
  3. If you find errors or would like enhancements to be made to any of the
  4. software in the MAEstro environment, please use this form to report
  5. errors or suggestions.  It will help us more quickly track down the
  6. error.
  7.  
  8. This error report form also covers the User's Guide.  If some part of
  9. the User's Guide does not make sense to you, please report that as an
  10. error so we can rewrite the User's Guide to make things more clear.
  11.  
  12. If you don't want to follow the form exactly, that's fine.  It is just
  13. a suggested way to report errors; we have tried to include all the
  14. pertinent information we need to fix errors here.
  15.  
  16. Please mail the following form, with your information, to
  17.  
  18.     maestro@sioux.stanford.edu
  19.  
  20. -------------------------- Begin Here --------------------------
  21. 1. Which software is causing the problem?
  22.    (e.g., DisplayTool, the Port Manager, vcrEdit, File Browser,
  23.     User's Guide, etc.)
  24.  
  25.     Your Answer Here
  26.  
  27. 2. What type of problem is it, briefly?
  28.    (e.g., software doesn't compile, software crashes at run-time, I
  29.     don't understand how to use your software with my applications,
  30.     the User's Guide doesn't make sense somewhere, I can't print the
  31.     User's Guide, etc.)
  32.  
  33.     Your Answer Here
  34.  
  35. 3. Please describe the problem in as much detail as you can.
  36.    The more information you can provide, the better chance we'll have
  37.    of fixing the problem.
  38.  
  39.     Start Describing Here; Take As Much Space As You Need
  40.  
  41. 4. Is the problem consistently reproducible?  If so, how can we
  42.    reproduce the problem?  Are there any data files you could send to
  43.    help us reproduce the problem?
  44.  
  45.     Include Explanation (And Relevant Files) Here
  46.  
  47. 5. Can you include a transcript of the problem?
  48.    * If the problem is a compilation problem, please include the
  49.      output of "make", so we can see exactly what line(s) are
  50.      causing the problem.
  51.    * If the problem is at run-time, a stack trace would be of great
  52.      help.  Run gdb, CenterLine CodeCenter, or dbx on the core file
  53.      dumped by the applications that crashed, and send the stack trace
  54.      and all the values of currently known variables, if possible.
  55.      You can't send too much debugger information.  If you don't know
  56.      how to produce a stack trace, please send mail to
  57.      maestro@sioux.stanford.edu  and we'll be happy to help you produce one.
  58.      It might be helpful to rerun the application with a non-stripped
  59.      version of the software, so the debugger can better tell us where
  60.      the problem happened.  By default, the MAEstro applications are
  61.      installed stripped to decrease size; you might re-install not
  62.      stripped; the master Makefile tells you how.
  63.  
  64. 6. Do you know what caused the problem?  If so, that would save us
  65.    time trying to track down the cause if you already know.
  66.  
  67.     Your Answer Here
  68.  
  69. 7. Do you have a fix for the error?  If so, please include any
  70.    relevant code, instructions, etc.  Keep in mind that they will
  71.    become property of Stanford University (we have to say that; please
  72.    excuse us).
  73.  
  74.     Include Explanation And Relevant Information Here
  75.  
  76. 8. Do you have suggestions for improvements?
  77.  
  78.     Your Answer Here; Take As Much Space As You Need
  79.  
  80. 9. Any other comments or information you would like to add?
  81.  
  82.     Your Answer Here; Take As Much Space As You Need
  83.  
  84.  
  85.